ACS TPO Policy Configuration Mode Commands

ACS TPO Policy Configuration Mode Commands
 
The ACS TPO Policy Configuration Mode is used to configure Traffic Performance Optimization (TPO) policies.
note_smallImportant: The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).
ad-filter
This command allows you to configure the bypass string for the Advertisement Filter feature.
Product
TPO
Privilege
Security Administrator, Administrator
Syntax
ad-filter ad-click-identity bypass_string
no ad-filter ad-click-identity
no
Removes the bypass string if previously configured.
bypass_string
Specifies the bypass string.
bypass_string must be an alphabetic string of 1 through 14 characters.
note_smallImportant: The bypass string must consist of any of the following characters: “abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ”. Numeric and special characters are not accepted.
Usage
Use this command to configure the bypass string for the Advertisement Blocking with On-click feature. To enable retrieving a blocked advertisement requested by the subscriber, in the HTTP request the bypass string is added to the advertisement’s URL, which TPO interprets and forwards to the Web Server allowing the advertisement to be retrieved.
Example
The following command configures the bypass string as allow:
ad-filter ad-click-identity allow
end
Exits the current configuration mode and returns to the Exec mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
end
Usage
Use this command to return to the Exec mode.
exit
Exits the current mode and returns to the parent configuration mode.
Product
All
Privilege
Security Administrator, Administrator
Syntax
exit
Usage
Use this command to return to the parent configuration mode.
match-ad
This command allows you to define rules to match advertisements.
Product
TPO
Privilege
Security Administrator, Administrator
Syntax
match-ad priority rule_priority tpo-ruledef tpo_ruledef_name
no match-ad priority rule_priority
no
If previously configured, removes the specified TPO match-advertisement rule from the current TPO policy.
priority rule_priority
Specifies the priority of the TPO match-advertisement rule in the current TPO policy.
rule_priority must be an integer from1 through 65535, and must be unique in the current TPO policy.
tpo-ruledef tpo_ruledef_name
Specifies the TPO rule to add/remove from the current TPO policy.
tpo_ruledef_name must be the name of a TPO ruledef, and must be an alphanumeric string of 1 through 63 characters.
Usage
Use this command to define the rules to block advertisements.
Example
The following command creates a match-advertisement rule to use the TPO ruledef named tporule1 with the priority 1:
match-ad priority 1 tpo-ruledef tporule1
match-rule no-ruledef-match
This command allows you to specify the action to be taken when the traffic does not match any TPO ruledef.
Product
TPO
Privilege
Security Administrator, Administrator
Syntax
match-rule no-ruledef-match tpo { none | profile tpo_profile_name }
default match-rule no-ruledef-match
default
Configures this command with its default setting.
Default: none. No TPO profile is selected.
none
Specifies that no TPO profile be used.
profile tpo_profile_name
Specifies the TPO profile to use when there is no rule match.
tpo_profile_name must be the name of a TPO profile, and must be an alphanumeric string of 1 through 63 characters.
Usage
Use this command to specify the action to be taken when the traffic does not match any TPO ruledef in the TPO policy.
Example
The following command specifies to use a TPO profile named tpo_profile2 when the traffic does not match any TPO ruledefs in the TPO policy:
match-rule no-ruledef-match tpo profile tpo_profile2
match-rule priority
This command allows you to specify the TPO profile to use when the traffic matches a particular TPO ruledef/TPO group-of-ruledefs.
Product
TPO
Privilege
Security Administrator, Administrator
Syntax
match-rule priority rule_priority { tpo-group-of-ruledefs tpo_group_of_ruledefs_name | tpo-ruledef tpo_ruledef_name } tpo { none | profile tpo_profile_name } [ description description ]
no match-rule priority rule_priority
no
Removes the specified match rule configuration.
match-rule priority rule_priority
Specifies priority of the rule within the TPO policy.
rule_priority must be an integer from1 through 65535, and must be unique in the current TPO policy.
tpo-group-of-ruledefs tpo_group_of_ruledefs_name
note_smallImportant: The tpo-group-of-ruledefs option is available only in 12.2 and later releases.
Specifies the TPO group-of-ruledefs.
tpo_group_of_ruledefs_name must be the name of the TPO group-of-ruledefs, and must be an alphanumeric string of 1 through 63 characters.
If any of the ruledefs within a group-of-ruledefs match, that group-of-ruledefs is considered a match.
tpo-ruledef tpo_ruledef_name
Specifies the TPO rule.
tpo_ruledef_name must be the name of a TPO ruledef, and must be an alphanumeric string of 1 through 63 characters.
tpo { none | profile tpo_profile_name }
Specifies the TPO profile to be used.
•
none: Specifies that no TPO profile be used.
•
profile tpo_profile_name: Specifies the TPO profile to be used. tpo_profile_name must be the name of a TPO profile, and must be an alphanumeric string of 1 through 63 characters.
description description
Adds the specified description to this rule priority configuration.
description must be an alphanumeric string of 1 through 127 characters.
Usage
note_smallImportant: A maximum of 2048 optimization rules can be configured in the system.
Use this command to specify the TPO profile to use when the traffic matches a particular TPO ruledef/TPO group-of-ruledefs in the TPO policy.
This CLI command can be entered multiple times to specify multiple rules and TPO profiles. The rules are examined in order of priority, until a match is found and the corresponding TPO profile is applied. Lower numbered priorities are examined first.
Example
The following command creates a rule match configuration to use the TPO profile named tpoprofile1 when the traffic matches the TPO ruledef named tporule1 with priority 1:
match-rule priority 1 tpo-ruledef tporule1 tpo profile tpoprofile1
 
 
Cisco Systems Inc.
Tel: 408-526-4000
Fax: 408-527-0883